The HTTP API > The HTTP API > MMHttp.getFileCallback() |
![]() ![]() ![]() |
Description
Gets the file at the specified URL, saves it in the Configuration/Temp folder inside the Dreamweaver application folder on the user's hard disk, and then calls the specified function with the request ID and reply result. When saving the file locally, Dreamweaver automatically creates subfolders that mimic the directory structure of the server; for example, if the specified file is at http://www.dreamcentral.com/people/index.html, Dreamweaver stores the index.html file in the People folder inside the www.dreamcentral.com folder.
Arguments
callbackFunction
, URL
, {prompt}
, {saveURL}
, {titleBarLabel}
![]() |
The first argument is the name of the JavaScript function to call when the HTTP request is complete. |
![]() |
The second argument is an absolute URL on a Web server; if "http://" is omitted from the URL, it is assumed. |
![]() |
The third argument is a Boolean value that specifies whether to prompt the user to save the file. If saveURL is outside the Configuration/Temp folder, a prompt value of false is ignored for security reasons. |
![]() |
The fourth argument is the location on the user's hard disk where the file should be saved, expressed as a file:// URL. If prompt is true or saveURL is outside the Configuration/Temp folder, the user can override saveURL in the Save dialog box. |
![]() |
The fifth argument is the label that should appear in the title bar of the Save dialog box. |
Returns
An object that represents the reply from the server. The data
property of this object is a string containing the location where the file was saved, expressed as a file:// URL. Normally the statusCode
property of the object contains the status code received from the server. However, if a disk error occurs while Dreamweaver is saving the file on the local drive, the statusCode
property contains an integer representing an error code. See MMHttp.getFile() for a list of possible error codes.
![]() ![]() ![]() |